<html><head><title>CustomDashPath</title></head>
<body bgcolor="#EFF1F0" link="#3A3966" vlink="#000000" alink="#000000">
<font face="Verdana, sans-serif" size="2"><p align="center"><b><font size="4">CustomDashPath()</font></b></p>
<p><b>Syntax</b></p><blockquote>
<font color="#3A3966"><b>CustomDashPath</b></font>(Width.d, Array.d() [, Flags [, StartOffset.d]])</blockquote>

</blockquote>
<b>Description</b><br><blockquote>

Draw the current drawing path with a custom dashing pattern. 
<br>
<br>
By default, the path is reset after calling this function. This can be prevented with the appropriate flags. 

</blockquote><p><b>Parameters</b></p><blockquote>
<style type="text/css">
table.parameters { border-spacing: 0px; border-style: none; border-collapse: collapse; }
table.parameters td { border-width: 1px; padding: 6px; border-style: solid; border-color: gray; vertical-align: top; font-family:Arial; font-size:10pt; }
</style>
<table width="90%" class="parameters">
<tr><td width="10%"><i>Width.d</i></td>
<td width="90%"> 
Specifies the width for the dashed line. 

</td></tr>
<tr><td><i>Array.d()</i></td>
<td> 
Specifies the length of each dash and each space to the next dash. The array must have 
an even number of entries. When the drawing operation reaches the end of the array, the 
pattern is repeated. A dash length of 0 will draw a single dot. 

</td></tr>
<tr><td><i>Flags (optional)</i></td>
<td> 
Specifies optional characteristics for the drawn dashes. This can be a combination of the following values: 
<pre><font face="Courier New, Courier, mono"size="2">  <font color="#924B72">#PB_Path_Default</font>       : No special behavior (default value)
  <font color="#924B72">#PB_Path_Preserve</font>      : Don't reset the path after this function
  <font color="#924B72">#PB_Path_RoundEnd</font>      : Draw the dashes with a rounded ends
  <font color="#924B72">#PB_Path_SquareEnd</font>     : Draw the dashes with a square box at the ends
  <font color="#924B72">#PB_Path_RoundCorner</font>   : Draw the dashes with rounded corners
  <font color="#924B72">#PB_Path_DiagonalCorner</font>: Draw the dashes with diagonally cut corners
</font></pre>

</td></tr>
<tr><td><i>StartOffset.d (optional)</i></td>
<td> 
Specifies the distance to skip within the dash pattern before starting to draw the path. 
The default value is 0. 

</td></tr>
</table>
</blockquote><p><b>Return value</b></p><blockquote>
None.


</blockquote><p><b>Example</b></p><blockquote>


<pre><font face="Courier New, Courier, mono"size="2">  <b><font color="#3A3966">If</font></b> <font color="#3A3966">OpenWindow</font>(0, 0, 0, 400, 200, &quot;VectorDrawing&quot;, <font color="#924B72">#PB_Window_SystemMenu</font> | <font color="#924B72">#PB_Window_ScreenCentered</font>)
<font color="#3A3966">    CanvasGadget</font>(0, 0, 0, 400, 200)

    <b><font color="#3A3966">If</font></b> <font color="#3A3966">StartVectorDrawing</font>(<font color="#3A3966">CanvasVectorOutput</font>(0))
    
<font color="#3A3966">      MovePathCursor</font>(40, 20)
      <b><font color="#3A3966">For</font></b> i = 1 <b><font color="#3A3966">To</font></b> 4
<font color="#3A3966">        AddPathLine</font>(80, 0, <font color="#924B72">#PB_Path_Relative</font>)
<font color="#3A3966">        AddPathLine</font>(0, 40, <font color="#924B72">#PB_Path_Relative</font>)
      <b><font color="#3A3966">Next</font></b> i
      
<font color="#3A3966">      VectorSourceColor</font>(<font color="#3A3966">RGBA</font>(255, 0, 0, 255))
      
      <b><font color="#3A3966">Dim</font></b> <font color="#3A3966">dashes</font>.d(7)
<font color="#3A3966">      dashes</font>(0) = 20
<font color="#3A3966">      dashes</font>(1) = 10
<font color="#3A3966">      dashes</font>(2) = 0 <font color="#3A3966">; draw a dot</font>
<font color="#3A3966">      dashes</font>(3) = 10
<font color="#3A3966">      dashes</font>(4) = 0
<font color="#3A3966">      dashes</font>(5) = 10
<font color="#3A3966">      dashes</font>(6) = 20
<font color="#3A3966">      dashes</font>(7) = 10
<font color="#3A3966">      CustomDashPath</font>(5,<font color="#3A3966"> dashes</font>())
    
<font color="#3A3966">      StopVectorDrawing</font>()
    <b><font color="#3A3966">EndIf</font></b>
    
    <b><font color="#3A3966">Repeat</font></b>
      Event =<font color="#3A3966"> WaitWindowEvent</font>()
    <b><font color="#3A3966">Until</font></b> Event = <font color="#924B72">#PB_Event_CloseWindow</font>
  <b><font color="#3A3966">EndIf</font></b>
</font></pre>

<p><img src="../HelpPictures/customdashpath.png"></p>

</blockquote><p><b>See Also</b></p><blockquote>

<a href="fillpath.html">FillPath()</a>, <a href="strokepath.html">StrokePath()</a>, <a href="dotpath.html">DotPath()</a>, <a href="dashpath.html">DashPath()</a>, <a href="isinsidestroke.html">IsInsideStroke()</a>, <a href="resetpath.html">ResetPath()</a> 

</Blockquote><p><b>Supported OS </b><Blockquote>All</Blockquote></p><center><- <a href=convertcoordinatey.html>ConvertCoordinateY()</a> - <a href="index.html">VectorDrawing Index</a> - <a href="dashpath.html">DashPath()</a> -><br><br>

</body></html>